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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 



This Technical Specification (TS) has been produced by ETSI Technical Conmiittee Machine-to-Machine 
communications (M2M). 
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1 Scope 

The present document contains BBF TR-069 compatible Data Model for ETSI M2M. 



References 



References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http ://docbox . etsi . or g/Ref erence . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[1] ETSI TS 102 690: "Machine-to-Machine communications (M2M); Functional architecture". 

[2] ETSI TS 102 921: "Machine-to-Machine communications (M2M); mla, dia and mid interfaces". 

[3] BBF: TR-069, CPE WAN Management Protocol, Issue 1, Amendment 4, July 201 1, 

Protocol version 1.3. 

NOTE: Available at http://www.broadband-forum.org/technical/download/TR-106 Amendment-4.pdf . 

[4] BBF: TR-106 Data Model Template for TR-069-Enabled Devices, Issue 1, Amendment 6, 

July 2011. 

NOTE: Available at http://www.broadband-forum.org/technical/download/TR-106 Amendment-6.pdf . 

[5] BBF: TR-181 Device Data Model for TR-069, Issue 2. 

[6] IETF/RFC 3986: Uniform Resource Identifier (URI): Generic Syntax. . 

[7] POSIX. 1-2008: The Open Group Technical Standard Base Specifications, Issue 7. 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

[i.l] Liaison Statement from BBF to ETSI TC M2M. December 02nd 201 1. Document ETSI 

M2M( 12)19-011 -ETSI-M2M-Service-TR-069-Data-Model. 

[i.2] ETSI TR 102 725: "Machine to Machine Communications (M2M); Definitions". 

NOTE: Explanations on the acronyms and abbreviations used in the present document can be found in 
TR 102 725. 
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3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 102 725 [i.2] apply. 

3.2 Symbols 

For the purposes of the present document, the symbols given in TR 102 725 [i.2] apply. 

3.3 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 102 725 [i.2] apply. 



General principles 



In its TR-069 [3] the BroadBand Forum specifies a protocol for communication between a CPE (Customer Premises 
Equipment) and an ACS (Auto-Configuration Server). 

Any TR-069 compHant device (the CPE) has to follow the data model as described in the TR-106 [4] and TR-181 [5]. 

ETSI M2M defines a Device Management function that allows to remotely configure the M2M Devices by using 
already existing Device Management protocols (e.g. BBF-TR-069, OMA-DM, etc.). Due to the RESTfull nature of the 
interface with the M2M Applications, some ETSI Management Objects are specified and modelled as REST resources 
in [1]. 

Some of these ETSI resources may be mapped on already existing Data Models / Management Objects as defined by 
BBF or/and OMA. The corresponding mapping rules are specified in [2]. 

Some other resources do not correspond to any existing Data Models/Management Objects as defined by BBF or/and 
OMA. The present document defines the corresponding BBF-TR-069 compatible Data Model. 

The data model for a TR-069 enabled device has to follow a common set of requirements (see in the TR-181 [5]). A 
data hierarchy is specified based on a single Root Object which is called "Device". Each Managment Object is a sub- 
element of this Root object. 

Broadband Forum decided to implement the ETSI Management Objects at root level of the tree. It means that the ETSI 
Management Objects are directly implemented at "Device" level. 

The 3 ETSI Management Objects (etsiSclMo, etsiAreaNwklnfo, and etsiAreaNwkDevicelnfo) are gathered together in 
one single ETSI M2M Management Object. 

When a data structure is represented by comma separated list of type "string", if a comma is contained in an item of 
such a list, the comma shall be escaped by using '\' . 



IM2ETSMservice: 1.0 Data Model 



NOTE: The data model contained in table 1 is a Broadband Forum work and it is still a work in progress (as 
mentioned by BBF in a LS sent to ETSI TC M2M referenced in [i.l]). 

The exact mapping between the attributes and sub-resources of the ETSI resource and the elements of table 1 is 
specified in [2], annex E. 
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Table 1 : BBF Data Model for ETSI M2M Management Objects 



^^^^■^ Name Type 


Write Description Object Version 


Device.ETSIM2M. 


object 




The ErS/M2M object represents the 
management object for the Remote Entity 
Functions (REM) functions defined in the 
M2M Functional Architecture (ETSIM2MFA 
[1])- 




2.99 


SCLNumberOfEntries 


unsignedint 


- 


The number of entries in the SCL table. 


- 


2.99 


Device.ETSIM2M.SCL{i}. 


object 


W 


This object represents an instance of a 

Service Capability Layer (SCL) for a M2M 

device or gateway. 

The SCL MAY be maintained by the ACS or 

by the CPE. 

When the SCL provides the administration of 

an SCL that is represented as a 

SoftwareModules.ExecutionilnitXhe SCL is 

maintained in the 

SoftwareModules. Executionilnit. {i}.Referenc 

es parameter. 

Clause 5.1 .2 of the M2M Functional 

Architecture (ETSIM2MFA [11) describes the 

high level event flows for SCL registration. 

Clause 9.3.2.6.2 of the M2M Functional 

Architecture (ETSIM2MFA [ID describes the 

creation/registration of SCLs. 

Clause 9.3.2.6.4 of the M2M Functional 

Architecture (ETSIM2MFA [ID describes the 

update/re-registration of SCLs. 

Clause 9.3.2.6.5 of the M2M Functional 

Architecture (ETSIM2MFA [ID describes the 

deletion/deregistration of SCLs. 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE MUST choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 

At most one enabled entry in this table can 

exist with a given value for SCUD. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


AnnouncedToSCLList 


string 


W 1 Comma-separated list of strings. The list 
represents an unordered set of URIs 
(RFC 3986 [6]). 

A list item is a URI string that represents a 
SCL to which this SCL will announce original 
1 (local) resources. 




2.99 
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^^H Name Type Write Description Object Version ' 








The AnnouncedToSCL has an interest in the 
discovery of the local resource. Clause 
9.2.1.14 Announced Resource of the M2M 
Functional Architecture (ETSIM2MFA [ID 
provides a description of this behaviour of an 
Announced Resource. 
Clause 9.3.2.28 of the M2M Functional 
Architecture (ETSIM2MFA [ID and Clause 
7.3.2.7 of the M2M mla, dia and mid 
Interfaces (ETSIM2Mlnterfaces [21) 
describes the process of announcing and 
denouncing of resources within a 
ETSIM2M.SCL. 






SAFPolicySetNumberOfEntries 


unsignedint 


- 


The number of entries in the SAFPolicySet 
table. 


- 


2.99 


AreaNwklnstanceNumberOfEntri 
as 


unsignedint 


- 


The number of entries in the 
AreaNwklnstance table. 


- 


2.99 


AreaNwkDevicelnfolnstanceNum 
berOfEntries 


unsignedint 


- 


The number of entries in the 
AreaNwkDevicelnfolnstance table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.Discove 
ry. 


object 




This object is represents the administration 
properties used when a NSCL requests 
discovery of resources within the 
ETSIM2M.SCL. 

Clause 9.3.2.27 of the M2M Functional 
Architecture (ETSIM2MFA [ID describes the 
process of discovery of resources within a 
ETSIM2M.SCL. 




2.99 


MaxNumberOfDiscovRecords 


unsignedint 


W 


The maximum number of URIs 

(RFC 3986 [6]) for discovered resources 

contained in a discovery result. 

This parameter and the 

MaxSizeOfDiscovAnswer parameter are 

mutually exclusive in that a result can be 

limited due to the bounds of either 

parameter. 

A value of indicates that the SCL does not 

have a limit for this parameter. 




2.99 


MaxSizeOfDiscovAnswer 


unsignedint 


W 


The maximum size in bytes of the Discovery 

Answer. 

This parameter and the 

MaxNumberOfDiscovRecords parameter are 

mutually exclusive in that a result can be 

limited due to the bounds of either 

parameter. 

A value of indicates that the SCL does not 

have a limit for this parameter. 




2.99 


Device.ETSIM2M.SCL.{i}.Reregis 
tration. 


object 


_ 


This object represents the properties and 
status necessary for a SCL to reregister with 
one or more NSCLs. 




2.99 


RegTargetNSCLList 


string 


w 


Comma-separated list of strings. The list 
represents a priority ordered set of URIs 
(RFC 3986 [6]). The item that is first in the 
list has the highest priority. 
A list item is a URI (RFC 3986 [6]) string that 
represents a NSCL that this SCL can use in 
order to attempt registration. 
When modified the contents of this 
parameter replace the RegTargetNSCLList 
received during the bootstrap procedure. 


- 


2.99 
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^^^H Name Type Write Description Object Version ' 


RegSearchStrings 


string 


W 


Comma-separated list of strings. The list 
represents the string tokens used as keys 
when searching for this SCL instance. 
Clauses 9.2.3.6.2 and 9.2.3.6.4 of the M2M 
Functional Architecture (ETSIM2MFA [ID 
describe the usage for this parameter. 




2.99 


RegAccessRightID 


string 


W 


URI (RFC 3986 [6]) that represents the 
identifier of the access right resource. The 
value of this parameter is maintained by the 
NSCL and used by the SCL as a default 
access right identifier for re-registration to 
NSCLs. 




2.99 


RegExpirationDuration 


long 


W 


The duration, in seconds, that the SCL will 
use in its next re-registration attempt. Any 
negative value represents an infinite 
duration. 


-1 


2.99 


Reregistration 


boolean 


W 


The value of this parameter is not part of the 
device configuration and is always false 
when read. When set to true, triggers an 
immediate re-registration action where the 
SCL re-registers with the SCLs in the 
RegTargetNSCLList . 




2.99 


Device. ETSIM2M.SCL.{i}.Reregis 
tration.ActionStatus. 


object 


- 


This object represents the status of the 
Reregistration action. 


- 


2.99 


Progress 


unsignedlnt- 
[0:100] 




The progress, in percent, of the 
Reregistration action. The progress is 
measured from % to - 1 00 %. A value of 
indicates that the action has not started. A 
value of 100 indicates that the action has 
completed. 




2.99 


FinalStatus 


string 




The completion status of the Reregistration 

operation. Enumeration of: 

SUCCESS 

FAILURE 




2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}. 


object 


w 


This object describes the parameters 
necessary to administer the store-and- 
forward (SAF) handling policies applied to 
requests to access remotely hosted 
resources. 

Policies are described by instances of 
SAFPolicySet. Which instances of 
SAFPolicySet is used by the SCL is 
determined by the PolicyScope parameter. 
Clause 9.3.1 .5 of the M2M Functional 
Architecture (ETSIM2MFA [ID and Clause 
7.3.1 .2.2 of the M2M mla, dia and mid 
Interfaces (ETSIM2Mlnterfaces [2D describe 
the behaviour for SAF processing. 
There is at most one S/\FPo//cySef instance 
with the PoZ/cKScojoe containina a soecific 
application id (APP-ID) URI value within the 
list. 

There is exactly one S/AFPo//cySef instance 
with a Po//cyScope value of "default". 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W Administratively enables or disables this 
(instance. 


false 


2.99 
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^^f Name Type 


Write Description Object Version ' 
default j 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


PolicyScope 


string 


W 


Comma-separated list of strings. The 

parameter defines the scope of the policies 

contained in this instance of a SAFPolicySet 

The parameter value is: 

a list of unordered set of URIs 

(RFC 3986 [6]) that represents an M2M 

application id (APP-ID) 

the value of "default" 

an empty string 

When this parameter is set to a list of 

application id (APP-ID) URIs (RFC 3986 [6]), 

the scope indicates that the policies are 

applicable to requests coming from any 

specific application on that list. 

When this parameter is set to a string with 

the value "default", the scope indicates that 

the policies are the default policies for this 

ETSIM2M.SCL. 

When this parameter is set to an empty 

string, the value represents an unknown 

SAFPolicySet audi the SAFPolicySet \s not to 

be used. 


<Empty> 


2.99 


ANPPolicyNumberOfEntries 


unsignedint 


- 


The number of entries in the ANPPolicy 
table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.ANPPolicy.{i}. 


object 


w 


This table contains the SAF-handling policies 

which are controlled by the Access Network 

Provider(s). 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE MUST choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 

At most one enabled entry in this table can 

exist with a given value for ANName. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 
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^^f Name Type 


Write Description Object Version ' 
default j 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in 

Section 3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


ANName 


string 


W 


This parameter is the name of the access 
network provider and used to determine for 
which access network the policies defined in 
the ANPPolicy \ab\e will apply. 


<Empty> 


2.99 


BlockPeriodNumberOf Entries 


unsignedint 


- 


The number of entries in the BlockPeriod 
table. 


- 


2.99 


RCATSclieduleNumberOfEntries unsignedint - Tiie number of entries in tiie /=?C/\rSc/7ecy^/e - 2.99 

table. 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.ANPPolicy.{i}.BIockPeri 
od.{i}. 


object 


w 


This table contains a list of block periods for 
a ANPPolicy. 

A block period defines how long the device 
will wait before re-trying to establish 
connectivity via the access network 
associated with the policy's ANName 
parameter after the previous attempt has 
failed. 

At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 
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^^H Name Type Write Description Object Version ' 
1^^ ^^^^^^ default j 


FailedAttempts 


unsignedint 


W 


Number of consecutively failed access 
attempts for which the BlockDuration will be 
used to block the next access attempt. 
The SCL will apply the BlockPeriod enXry 
with the largest number of consecutive failed 
attempts that is smaller or equal to the actual 
number of consecutive failed attempts. 





2.99 


BlockDuration 


long 


W 'The duration, in seconds, to which to block ' ' 2.99 
further access attempts. 


Device.ETSIM2M.SCL{i}.SAFPol 
icySet.{i}.ANPPolicy.{i}.RCATSch 
edule.{i}. 


object 


W 


This table contains a list of Request 
Category (RCAT) schedule policy items for 
defining when it is appropriate to use the 
access network associated with the 
ANName. parameter value for processing 
requests of specific RCAT values. 
The combination of all instances of the 
AbsTimeSpan along with the Schedules 
parameter makes up the RCAT schedule. 
The Schedules parameter defines a 
recurrence of the schedule and the 
AbsTimeSpan, if present, places constraints 
on the schedule recurrence. 
Processing behaviour for the use of RCAT 
Schedules is defined in Clause 7.3.1.2.2.1 of 
the M2M mla, dia and mid Interfaces 
(ETSIM2Mlnterfaces [21) document. 
The instance is uniquely identified by the 
RCATList. In addition, the value of an item 
within the RCATList is unique across all 
instances of the RCATSchedule. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W Administratively enables or disables this 
, instance. 


false 


2.99 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in 

(Section 3.6.1/TR-069a4 [31) and described 

in (Aooendix ll/TR-069a4 [31), the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


RCATList 


string 


W 


Comma-separated list of strings. The list is a 
set of RCATs. 

An RCAT is a string that represents a 
request category used for policy 
enforcement for access to a provider's 
access network. 


<Empty> 


2.99 
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^^^H Name Type Write Description Object Version ' 


Schedules 


string 


W 


Comma-separated list of strings. The list is a 
set of schedule strings. 
A Schedules string is a string formatted 
according to the date and time fields defined 
CRONTAB input file definition in 
(POSIXBase [7]). 

The Schedules is used to set the recurrence 
of the schedule. 

Note the command field is not used in this 
definition and any whitespace or comma 
characters within a Schedule string MUST 
be escaped using percent as defined in 
Section 3.2.3/TR-106a5 [41 
Example of CRONTAB string: 
"*%200-6%20*%20*%201-5" would mean 
the period from 0:00h to 6:00h (inclusive) on 
any week day (Monday through Friday) 
"*%2022-2%2C,0-4%20*%20*%201 -5" 
would mean the period from 22:00h to 
04:00h on any week day (Monday through 
Friday) 


<Empty> 


2.99 


AbsTimeSpanNumberOf Entries 


unsignedint 


- 


The number of entries in the AbsTimeSpan 
table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.ANPPolicy.{i}.RCATSch 
edule.{i}.AbsTimeSpan.{i}. 


object 


W 


This object defines an instance of a time 

span used for determining an RCAT 

schedule. 

An instance of the AbsTimeSpan represents 

a time span in which the schedule 

recurrence defined in Schedules is 

constrained. 

AbsTimeSpan instances with unknown 

values for the StartTime or EndTime are 

ignored. 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE MUST choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


StartTime 


dateTime 


w 


Date and time that represents the start of the 
time span. 

The value 0001-01-01T00:00:00Z represents 
an unknown value. 


0001-01- 

01T00:00: 

OOZ 


2.99 
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^^^H Name 


Type 


Write Description Object Version ' 
default 1 


EndTime 


dateTime 


W 


Date and time that represents the end of the 

time span. 

The 9999-1 2-31 T23:59:59Z represents an 

infinite time span from the start time. 

The value 0001-01-01T00:00:00Z represents 

an unknown value. 


0001-01- 

01T00:00: 

OOZ 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.M2MSPPolicy. 


object 




This object maintains the SAP handling 
policies' properties that are controlled by the 
M2M service provider for a request. 
These include: 

Tolerable Request Processing Delay Time 
(TRPDT) for one or more RCATs 
Thresholds for the maximum number of 
pending requests for one or more RCATs 
Processing behaviour for the use of M2M 
Service Provider policies is defined in 
Clause 7.3.1 .2.2.1 of the M2M mla, dia and 
mid Interfaces (ETSIM2Mlnterfaces [21) 
document. 




2.99 


DefaultRCATValue 


string 


W 


The default RCAT value to use for requests 
to remotely hosted resources during SAP- 
handling when no RCAT value was specified 
in the request. 


<Empty> 


2.99 


DefaultTRPDTValuesNumberOfE 
ntries 


unsignedint 


- 


The number of entries in the 
DefaultTRPDTValues table. 


- 


2.99 


MaxPendReqsNumberOf Entries 


unsignedint 




The number of entries in the MaxPendReqs 
table. 


- 


2.99 


MaxPendDataNumberOf Entries 


unsignedint 


- 


The number of entries in the MaxPendData 
table. 


- 


2.99 


ANSelListNumberOf Entries 


unsignedint 


- 


The number of entries in the ANSelList \ab\e. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 

icySet.{i}.M2MSPPolicy.DefaultT 

RPDTValues.{i}. 


object 


w 


This object maintains a list of TRPDT 
properties to be used for forwarding requests 
with a specified RCAT value within the 
RCATList 

NOTE: Different instances of the 
DefaultTRPDTValues \ab\e MUST NOT 
contain list items with the same RCAT 
values in the RCATList. In other words, an 
RCAT value is unique across all instances of 
the DefaultTRPDTValues table. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 
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^^f Name Type 


Write Description Object Version ' 
default j 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


RCATList 


string 


W 


Comma-separated list of strings. The list is a 

set of RCATs. 

An RCAT is a string that represents a 

request category used for policy 

enforcement. 


<Empty> 


2.99 


TolerableDelay 


long 


w 


The tolerable duration, in seconds, that a 
request can be pending in SAP handling. 
Any negative value represents an infinite 
duration. 





2.99 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.M2MSPPolicy.MaxPend 
Reqs.{i}. 


object 


w 


This object maintains a list of threshold 
properties related to the number of requests 
in the request queue used for forwarding 
requests with a specified RCAT value within 
the RCATList. 

NOTE: Different instances of the 
MaxPendReqs table MUST NOT contain list 
items with the same RCAT values in the 
RCATList. In other words, an RCAT value is 
unique across all instances of the 
MaxPendReqs table. 
MaxPendReqs instances with unknown 
values for the Ttiresii are ignored. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in 

Section 3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 
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^^^H Name Type Write Description Object Version ' 


RCATList 


string 


W 


Comma-separated list of strings. The list is a 

set of RCATs. 

An RCAT is a string that represents a 

request category used for policy 

enforcement. 


<Empty> 


2.99 


Thresh 


unsignedint 


W 


The threshold of maximum number of 
pending requests permitted to be held for a 
specified RCAT. 





2.99 


Device.ETSIM2M.SCL{i}.SAFPol 
icySet.{i}.M2MSPPolicy.MaxPend 
Data.{i}. 


object 


W 


This object maintains a list of threshold 
properties related to the memory size of the 
request queue used for forwarding requests 
with a specified RCAT value within the 
RCATList. 

NOTE: Different instances of the 
MaxPendData table MUST NOT contain list 
items with the same RCAT values in the 
RCATList. In other words, an RCAT value is 
unique across all instances of the 
MaxPendData table. 

At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Aiias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Aiias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


RCATList 


string 


W 


Comma-separated list of strings. The list is a 

set of RCATs. 

An RCAT is a string that represents a 

request category used for policy 

enforcement. 


<Empty> 


2.99 


Mem 


string(16) 


W 


This parameter defines the maximum size of 
the request queue for pending requests 
permitted to be held for a specified RCAT. 
The format of the string is an integer with an 
appended memory unit (B - Bytes, K - 1024 
Bytes, M - 1048576 Bytes, G -1073741824 
Bytes). 

When the value is an empty string the 
memory threshold criteria for the associated 
RCATList will be ignored in SAP handling. 
([0-9]{0, 15} ?[BKMGm<Empty>) 
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^^^H Name 


Type 


Write Description Object Version ' 
^ default i 


Device.ETSIM2M.SCL.{i}.SAFPol 
icySet.{i}.M2MSPPolicy.ANSelLis 
t.{i}. 


object 


W 


This object contains a list of access network 
selection policy instances to govern selection 
of a preferred access network for processing 
requests pending in SAF-handling that are 
associated with given ranges of RCAT 
values. 

Different instances of the ANSelList MUST 
NOT contain list items with the same RCAT 
values in the RCATList. In other words, an 
RCAT value is unique across all instances of 
the /\A/Se//./snable. 

At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE MUST choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/TR-069a4 [31 and described in 

Aooendix ll/TR-069a4 [31, the followina 

mandatory constraints MUST be enforced: 

Its value MUST NOT be empty. 

Its value MUST start with a letter. 

If its instance object is created by the CPE, 

the initial value MUST start with a "cpe-" 

prefix. 

The CPE MUST NOT change the parameter 

value. 




2.99 


RCATLIst 


string 


w 


Comma-separated list of strings. The list is a 

set of RCATs. 

An RCAT is a string that represents a 

request category used for policy 

enforcement. 


<Empty> 


2.99 


RankedANList 


string 


W Comma-separated list of strings. Each list 
item IVIUST be the path name of a row in the 
/\A/PPo//cy table. If the referenced object is 
deleted, the corresponding item MUST be 
removed from the list. The list is a prioritized 
set of Access Networks where the 
preference of using an Access Network is 
based on order of the list items with the 
lowest order list item as the most preferred 
Access Network. 


<Empty> 


2.99 
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^^H Name Type Write Description Object Version ' 
I^H HHi^^ default 1 


Device.ETSIM2M.SCL.{i}.AreaNw 
klnstance.{i}. 


object 




The I\/I2I\/I Area Network information provides 
administration capabilities for remote 
management (REIVI) of M2M Devices (D', d) 
that are attached to the ETSIM2M.SCL. 
This object provides the administration of the 
properties needed by the SCL to remotely 
manage M2M Devices within a specific type 
of M2M Area network as defined by 
AreaNwkType. 

Multiple instances AreaNwklnstancemXh the 
same AreaNwkType is permitted. 
Clause 5.3.5 of the M2M Functional 
Architecture (ETSIM2MFA [11) describes the 
REM functionality expected of a SCL for an 
M2M Device. 

At most one entry in this table can exist with 
a given value for ID. 




2.99 


ID 


string 


- 


URI (RFC 3986 [6]) that represents the 
identifier of the instance. 


- 


2.99 


AreaNwkType 


string 




Devices (D' and d) that connect to an SCL 

are said to be "attached devices" and are 

organized by M2M Area Networks within the 

ETSIM2M.SCL. 

The mechanism that a SCL uses to indicate 

the type of M2M Area Networks and their 

associated devices is implementation 

specific with the following constraints: 

Devices must be of the same Area Network 

Type (e.g. Zigbee). 

Devices must be attached to the same SCL 

instance. 




2.99 


MTU 


unsignedint 


- 


The maximum transmission unit in this area 
network. 


- 


2.99 


ListOfDevices 


string 




Comma-separated list of strings. Each list 
item MUST be the path name of a row in the 
AreaNwkDevicelnfolnstance {ab\e, or an 
empty string. 

The list represents the M2M Devices (D', d) 
that are attached to this SCL instance that 
are within this M2M Area Network. The list 
does not contain an instance for this CPE. 




2.99 


PropertyNumberOf Entries 


unsignedint 


- 


The number of entries in the Properfy table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNw 
klnstance.{i}.Property.{i}. 


object 




This object contains an instance of a 

property extension (name value pair) for the 

AreaNwklnstance. 

For example, if the AreaNwkType is ZIGBEE 

the AreaNwklnstance \n\\\ contain ZIGBEE 

specific parameters that have not been 

modelled for the M2M Area network. 

At a minimum, a property instance MUST 

exist that defines an attribute that describes 

the IP layer address type (e.g. IPv4, IPv6, 

non-IP) of this M2M Area Network. 




2.99 


Name 


string 


- 


The name of the property. 


- 


2.99 


iValue 


string 


- 


The value of the property. 


- 


2.99 
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^^H Name Type Write Description Object Version ' 
I^H HHi^^ default 1 


Device.ETSIM2M.SCL.{i}.AreaNw 
kDevicelnfolnstance.{i}. 


object 




The I\/I2I\/I Area Network Device Information 
provides the administration capability to the 
SCL for maintenance of M2M Devices (D', d) 
that are attached to the ETSIM2M.SCL. 
While discovery and identification of devices 
by the M2M Gateway or Device (CPE) is 
implementation specific, each device is 
represented by an instance of the Hosts 
table. 

When the M2M Device is managed by the 
CWMP endpoint of the CPE, the 
AreaNwkDevicelnfolnstance is expected to 
be referenced by an instance of one of the 
following tables: 

ManagementServer. EmbeddedDevice 
ManagementServer. VirtualDevice 
Clause 5.3.5 of the M2M Functional 
Architecture (ETSIM2MFA [11) describes the 
REM functionality expected of a SCL to a 
M2M Device. 

This object instance provides the 
administration properties required by a SCL 
to remotely manage an instance of a M2M 
Device within a M2M area network. 
A M2M Device is associated with an 
instance of a M2M area network. 
This table contains parameters and 
information of the M2M Device related to 
each M2M Area Network. 
Instances of this table are created and 
deleted by the CPE. The ACS MAY modify 
the writeable parameters of this object 
instance but it is possible that the value set 
by the ACS is not retained between reboots 
of the M2M Device. 




2.99 


AreaNwklnstance 


string 


- 


The value MUST be the path name of a row 
in the AreaNwklnstance \ab\e. 


- 


2.99 


Host 


string 




Comma-separated list of strings. Each list 
item MUST be the path name of the Hosts. 
Host table entry that represents an active or 
inactive M2M Device. If the referenced 
object is deleted, the corresponding item 
MUST be removed from the list. 




2.99 


ListOfDeviceNeighbors 


string 




Comma-separated list of strings. Each list 
item MUST be the path name of a row in the 
Hosts. Host \ab\e. If the referenced object is 
deleted, the corresponding item MUST be 
removed from the list. References all the 
Hosts. Host {ab\e entries, whether active or 
inactive, that represent the reachable 
neighbours of this M2M Device (D' or d). 




2.99 


ListOfDeviceApplications 


string 




Comma-separated list of strings. The list is 
an unordered set of URIs (RFC 3986 [6]). 
A list item is an URI string that represents an 
application id (APP-ID) for the M2M D'A 
applications residing on the M2M Device for 
the associated AreaNwklnstance. 
Table B.58 of the M2M Functional 
Architecture (ETSIM2MFA [11) and describes 
this parameter. 
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^^H Name Type Write Description Object Version ' 


Sleeplnterval 


unsignedint 


W 


The interval, in seconds, between sleep 
periods for the device. 
A value of represents a device that does 
not sleep. 




2.99 


SleepDuration 


unsignedint 


W The duration, in seconds, of a sleep period. 
The value represents an unknown value. 
NOTE: When this value is modified, the CPE 
could modify the SleepDuration for this M2M 
, Device in other Area Networks. 




2.99 


Status 


string 




The sleep status of the device. 

Enumeration of: 

ASLEEP 

AWAKE 




2.99 


Active 


boolean 




Whether or not this M2M Device is currently 
attached to this SCL instance. 
The ability to list inactive M2M Devices is 
OPTIONAL. If the CPE includes inactive 
M2MDevices in this table. Active is set to 
/a/se for each inactive M2M Device. The 
length of time an inactive M2M Device 
remains listed in this table is a local matter to 
the CPE. 




2.99 


PropertyNumberOf Entries 


unsignedint 


- 


The number of entries in the Properfy table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNw 
kDevicelnfolnstance.{i}. Property.! 
i}- 


object 




This object contains an instance of a 
property extension (name value pair) for the 
AreaNwkDevicelnfolnstance. 
For example, if the AreaNwkType is 
ZIGBEE, the AreaNwkDevicelnfolnstance 
contains ZIGBEE-specific parameters that 
are not formally modelled for the 
AreaNwkDevicelnfolnstance. 




2.99 


Name 


string 


- 


The name of the property. 


- 


2.99 


Value 


string 


- 


The value of the property. 


- 
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Annex A (normative): 
ETSIM2MService xsd file 



NOTE: Reference to BBF xsd definition should be added later when BBF's work is done. 
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